home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / c / hash / RCS / Hash_EnumFirst.c,v < prev    next >
Text File  |  1988-06-20  |  2KB  |  77 lines
  1. head     1.1;
  2. access   ;
  3. symbols  ;
  4. locks    ; strict;
  5. comment  @ * @;
  6.  
  7.  
  8. 1.1
  9. date     88.06.20.09.30.23;  author ouster;  state Exp;
  10. branches ;
  11. next     ;
  12.  
  13.  
  14. desc
  15. @@
  16.  
  17.  
  18.  
  19. 1.1
  20. log
  21. @Initial revision
  22. @
  23. text
  24. @/* 
  25.  * Hash_EnumFirst.c --
  26.  *
  27.  *    Source code for the Hash_EnumFirst library procedure.
  28.  *
  29.  * Copyright 1988 Regents of the University of California
  30.  * Permission to use, copy, modify, and distribute this
  31.  * software and its documentation for any purpose and without
  32.  * fee is hereby granted, provided that the above copyright
  33.  * notice appear in all copies.  The University of California
  34.  * makes no representations about the suitability of this
  35.  * software for any purpose.  It is provided "as is" without
  36.  * express or implied warranty.
  37.  */
  38.  
  39. #ifndef lint
  40. static char rcsid[] = "$Header: proto.c,v 1.2 88/03/11 08:39:08 ouster Exp $ SPRITE (Berkeley)";
  41. #endif not lint
  42.  
  43. #include "hash.h"
  44. #include "list.h"
  45.  
  46. /*
  47.  *---------------------------------------------------------
  48.  *
  49.  * Hash_EnumFirst --
  50.  *    This procedure sets things up for a complete search
  51.  *    of all entries recorded in the hash table.
  52.  *
  53.  * Results:    
  54.  *    The return value is the address of the first entry in
  55.  *    the hash table, or NULL if the table is empty.
  56.  *
  57.  * Side Effects:
  58.  *    The information in hashSearchPtr is initialized so that successive
  59.  *    calls to Hash_Next will return successive HashEntry's
  60.  *    from the table.
  61.  *
  62.  *---------------------------------------------------------
  63.  */
  64.  
  65. Hash_Entry *
  66. Hash_EnumFirst(tablePtr, hashSearchPtr)
  67.     Hash_Table *tablePtr;            /* Table to be searched. */
  68.     register Hash_Search *hashSearchPtr;    /* Area in which to keep state 
  69.                          * about search.*/
  70. {
  71.     hashSearchPtr->tablePtr = tablePtr;
  72.     hashSearchPtr->nextIndex = 0;
  73.     hashSearchPtr->hashEntryPtr = (Hash_Entry *) NULL;
  74.     return Hash_EnumNext(hashSearchPtr);
  75. }
  76. @
  77.